본문으로 건너뛰기

웹사이트 배포 가이드

배포 방식​

Admin Playbook 웹사이트는 Cloudflare Pages로 배포한다.

GitHub 저장소는 private으로 유지하고, Cloudflare Pages가 저장소를 읽어 Docusaurus 사이트를 빌드한다.

예상 공개 주소​

Cloudflare Pages 프로젝트 이름을 admin-playbook으로 만들면 기본 주소는 아래 형태가 된다.

https://admin-playbook.pages.dev/

프로젝트 이름이 이미 사용 중이면 Cloudflare가 다른 주소를 제안할 수 있다.

Cloudflare에서 한 번만 설정할 것​

  1. Cloudflare Dashboard에 로그인한다.
  2. Workers & Pages로 이동한다.
  3. Create application을 선택한다.
  4. Pages를 선택한다.
  5. Connect to Git을 선택한다.
  6. GitHub 계정을 연결한다.
  7. YGAFS/admin-playbook 저장소를 선택한다.

Build 설정​

Cloudflare Pages에서 아래 값으로 설정한다.

Project name: admin-playbook
Production branch: main
Framework preset: Docusaurus
Root directory: website
Build command: npm run build
Build output directory: build

환경변수는 웹사이트 빌드만 할 때는 필요 없다.

번역용 OPENAI_API_KEY는 로컬 번역 스크립트에서만 사용한다.

배포 흐름​

  1. Obsidian에서 문서를 편집한다.
  2. tools/sync-admin-playbook.cmd를 실행한다.
  3. GitHub private repo에 변경사항이 올라간다.
  4. Cloudflare Pages가 자동으로 Docusaurus 사이트를 빌드한다.
  5. Cloudflare Pages 주소에 새 문서가 반영된다.

언어 구조​

  • 기본 문서: 한글 원본
  • 영어 문서: _i18n/en에 승인된 번역본
  • 영어 초안: _i18n-drafts/en

웹사이트 빌드에는 한글 원본과 승인된 영어본만 들어간다.

보안 메모​

GitHub 저장소가 private이어도 Cloudflare Pages 사이트는 기본적으로 공개 URL이다.

민감한 문서를 제한하려면 다음 단계에서 Cloudflare Access를 붙인다.